Copyright ã1992 by Scott Hess.  All Rights Reserved.

Utility installation

Stuart includes source code for a number of useful utility programs that can interact with some of Stuart's features (see the top-level section Utilities).  Installation requires no special abilities on the part of the user's account other than the ability to write to the chosen installation directories.

These programs should be installed someplace on the user's executable search PATH, as set in the user's shell startup file(s).  The source tree for these utilities is the Utilities directory in the Stuart2.4 distribution.  To install all of the utilities in ~/Unix/bin, go to the command-line and in the Utilities directory type:

make install

This will automatically move through the source directories and compile the programs as necessary and install them.  If you wish to only install selected utilities, specify which utilities to install using the SOURCEDIRS parameter to make:

make install SOURCEDIRS="osc soil"

If you wish to install the utilities somewhere other than ~/Unix/bin, use the INSTALLDIR parameter:

make install INSTALLDIR=/usr/local/bin

In general, if the files are to be installed for the entire host, they should be installed in /usr/local/bin, while if they are to be installed for a single user, they should be installed in that user's ~/Unix/bin directory.

To clean up the object files and remove the executables, run:

make clean

Precompiled versions of the utilities are included in their directories.  If you do not have the extended edition of NeXTSTEP, you'll have to install these files manually.  Just drag and drop the files into the appropriate directories.

Note:  The utility sources are NeXTSTEP2.0 sources.  So far as I'm aware, they compile correctly under NeXTSTEP3.0, but there may be some warnings from the compiler due to changes in the include files under NeXTSTEP3.0.  These can be safely ignored.